home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / stdlib / RCS / strtod.man,v < prev    next >
Encoding:
Text File  |  1989-01-06  |  2.2 KB  |  80 lines
  1. head     1.1;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.1
  10. date     89.01.05.18.00.47;  author ouster;  state Exp;
  11. branches ;
  12. next     ;
  13.  
  14.  
  15. desc
  16. @@
  17.  
  18.  
  19.  
  20. 1.1
  21. log
  22. @Initial revision
  23. @
  24. text
  25. @' Copyright 1989 Regents of the University of California
  26. ' Permission to use, copy, modify, and distribute this
  27. ' documentation for any purpose and without fee is hereby
  28. ' granted, provided that this notice appears in all copies.
  29. ' The University of California makes no representations about
  30. ' the suitability of this material for any purpose.  It is
  31. ' provided "as is" without express or implied warranty.
  32. ' 
  33. ' $Header: /sprite/lib/forms/RCS/proto.man,v 1.1 88/12/29 17:09:50 ouster Exp $ SPRITE (Berkeley)
  34. ' 
  35. .so \*(]ltmac.sprite
  36. .HS strtod cmds
  37. .BS
  38. .SH NAME
  39. strtod \- Convert character string to floating-point number
  40. .SH SYNOPSIS
  41. .nf
  42. \fB#include <stdlib.h>
  43.  
  44. \fBdouble
  45. \fBstrtod(\fIstring\fR, \fIendPtr\fR)
  46. .SH ARGUMENTS
  47. .AS "char *" endPtr
  48. .AP char *string in
  49. String containing ASCII representation of floating-point number.
  50. .AP char **endPtr out
  51. If not \fBNULL\fR, gives address of pointer to fill in with address of
  52. first character not forming part of number.
  53. .BE
  54.  
  55. .SH DESCRIPTION
  56. .PP
  57. The \fBstrtod\fR procedure parses a floating-point number in ASCII
  58. representation and returns a \fBdouble\fR result containing the
  59. binary form of the number.  The expected
  60. form of \fIstring\fR is an optional plus or minus sign, then a sequence
  61. of decimal digits optionally containing a decimal point, then an
  62. optional exponent part.  If the exponent part is present, it consists
  63. of the letter \fBE\fR (or \fBe\fR), then an optional plus or minus sign,
  64. then a sequence of decimal digits.  The entire floating-point number
  65. may be preceded by any amount of white space (as defined by the
  66. \fBisspace\fR procedure).
  67. .PP
  68. \fIStrtod\fR examines as many characters as possible from \fIstring\fR
  69. while still obeying the syntax rules given above.
  70. If \fIendPtr\fR is not \fBNULL\fR, then the address of the first
  71. character following the floating-point number is stored in \fI*endPtr\fR.
  72. .PP
  73. If \fIstring\fR does not refer to a floating-point number in the format
  74. given above, then zero is returned and \fIstring\fR will be stored at
  75. \fI*endPtr\fR.
  76.  
  77. .SH KEYWORDS
  78. convert, floating-point, string
  79. @
  80.